4D Chart v13
CT ON EVENT
- 4D Chart
-
- CT Area Control
-
- CT DO COMMAND
- CT Error
- CT EVENT FILTER
- CT EXPERT COMMAND
- CT EXPERT MODE
- CT GET AREA PROPERTY
- CT Get display
- CT GET DOCUMENT SIZE
- CT GET PROPERTIES
- CT Last event
- CT MENU STATUS
- CT ON ERROR
- CT ON EVENT
- CT ON MENU
- CT SET AREA PROPERTY
- CT SET DISPLAY
- CT SET DOCUMENT SIZE
- CT SET ENTERABLE
- CT SET PROPERTIES
CT ON EVENT
| CT ON EVENT ( method ) | ||||||||
| Parameter | Type | Description | ||||||
| method | String |
|
Method to execute | |||||
The CT ON EVENT command executes method whenever a previously specified event occurs. The events that cause method to execute are described by the CT EVENT FILTER command.
If method is an empty string, no method is executed. If the area in which the event occurs has both an object method and an event method, the object method executes last. CT ON EVENT is especially useful for 4D Chart areas in plug-in windows because they cannot have object methods.
When 4D Chart calls method, it returns four parameters ($1, $2, $3, and $4) that can be used to manage the event.
| Parameter | Type | Description |
| $1 | Longint | Represents the 4D Chart area in which the event took place. |
| $2 | Longint | Holds the event code. Equivalent of a call to CT Last event. |
| $3 | Longint | Table number of the form on which the area resides. If $3 equals -1, the area is in a plug-in window. |
| $4 | Longint | Number of the field into which the area is being autosaved. If $4 equals 0, the area is not being autosaved. |
If you plan to compile your database, you should declare these parameter types as follows:
C_LONGINT($1;$2;$3;$4)This example shows the installation of an event method. It opens a plug-in window, specifies Ctrl+click as the event (Command-click on Macintosh), and then installs the event method EventProc.
`Open plug-in window
vArea:=Open external window(20;50;400;350;0;"Chart";"_4D Chart")
`Install the method EventProc
CT ON EVENT("EventProc")
`Ctrl+click will call the method
CT EVENT FILTER(vArea;64)
Product: 4D Chart
Theme: CT Area Control
Number:
14515
Created:
Created: 4D Chart 1
